package com.sharer.last.service;

import java.util.Date;
import java.util.List;
import java.util.Map;
import java.util.Set;
import java.util.concurrent.TimeUnit;

public interface RedisService<T> {

    //=============================common============================

    /**
     * 指定缓存失效时间
     *
     * @param key  键
     * @param time 时间(秒)
     * @return
     */
    boolean setExpireTime(String key, long time);

    /*** 指定缓存失效时间
     *
     * @param key  键
     * @param time 时间
     * @param unit  时间单位
     * @return
     */
    boolean setExpireTime(String key, long time, TimeUnit unit);

    /**
     * 根据key 获取过期时间
     *
     * @param key 键 不能为null
     * @return 时间(秒) 返回0代表为永久有效
     */
    long getExpireTime(String key);

    /***设置key 过期时间
     *
     * @param key
     * @param date
     * @return
     */
    boolean setExpireAt(String key, Date date);

    /**
     * 批量删除key * @param pattern
     */
    void removePattern(String pattern);

    /**
     * 删除对应的value * @param key
     */
    void remove(String key);

    /**
     * 删除缓存
     *
     * @param key 可以传一个值 或多个
     */
    void remove(String... key);

    /**
     * 判断缓存中是否有对应的value * @param key * @return
     */
    boolean hasKey(String key);


    /***获取匹配的键值
     *
     * @param pattern
     */
    Set<String> keys(String pattern);
    //============================String=============================

    boolean set(String key, Object value);

    boolean set(String key, Object value, Long expireTime);

    boolean set(String key, Object value, Long expireTime, TimeUnit timeUnit);

    /**
     * 递增
     *
     * @param key   键
     * @param delta 要增加几(大于0)
     * @return
     */
    long incr(String key, long delta);

    /**
     * 递减
     *
     * @param key   键
     * @param delta 要减少几(小于0)
     * @return
     */
    long decr(String key, long delta);

    /**
     * 读取缓存 * @param key * @return
     */
    Object get(String key);

    //================================Map=================================

    /**
     * HashGet
     *
     * @param key  键 不能为null
     * @param item 项 不能为null
     * @return 值
     */
    Object hGet(String key, String item);

    List<T> hGetList(String key);

    /**
     * 获取hashKey对应的所有键值
     *
     * @param key 键
     * @return 对应的多个键值
     */
    Map<Object, Object> hmGet(String key);

    /**
     * HashSet
     *
     * @param key 键
     * @param map 对应多个键值
     * @return true 成功 false 失败
     */
    boolean hmSet(String key, Map<String, Object> map);

    /**
     * HashSet 并设置时间
     *
     * @param key  键
     * @param map  对应多个键值
     * @param time 时间(秒)
     * @return true成功 false失败
     */
    boolean hmSet(String key, Map<String, Object> map, long time);

    /**
     * 向一张hash表中放入数据,如果不存在将创建
     *
     * @param key   键
     * @param item  项
     * @param value 值
     * @return true 成功 false失败
     */
    boolean hSet(String key, String item, Object value);

    /**
     * 向一张hash表中放入数据,如果不存在将创建
     *
     * @param key   键
     * @param item  项
     * @param value 值
     * @param time  时间(秒)  注意:如果已存在的hash表有时间,这里将会替换原有的时间
     * @return true 成功 false失败
     */
    boolean hSet(String key, String item, Object value, long time);

    /**
     * 删除hash表中的值
     *
     * @param key  键 不能为null
     * @param item 项 可以使多个 不能为null
     */
    void hDel(String key, Object... item);

    /**
     * 判断hash表中是否有该项的值
     *
     * @param key  键 不能为null
     * @param item 项 不能为null
     * @return true 存在 false不存在
     */
    boolean hHasKey(String key, String item);

    /**
     * hash递增 如果不存在,就会创建一个 并把新增后的值返回
     *
     * @param key  键
     * @param item 项
     * @param by   要增加几(大于0)
     * @return
     */
    double hincr(String key, String item, double by);

    /**
     * hash递减
     *
     * @param key  键
     * @param item 项
     * @param by   要减少记(小于0)
     * @return
     */
    double hdecr(String key, String item, double by);


    /**
     * 获取hash所有key
     *
     * @param key
     * @return
     */
    Set<Object> hKeys(String key);

    //============================set=============================

    /**
     * 根据key获取Set中的所有值
     *
     * @param key 键
     * @return
     */
    Set<Object> sGet(String key);

    /**
     * 根据value从一个set中查询,是否存在
     *
     * @param key   键
     * @param value 值
     * @return true 存在 false不存在
     */
    boolean sHasKey(String key, Object value);

    /**
     * 将数据放入set缓存
     *
     * @param key    键
     * @param values 值 可以是多个
     * @return 成功个数
     */
    long sSet(String key, Object... values);

    /**
     * 将set数据放入缓存
     *
     * @param key    键
     * @param time   时间(秒)
     * @param values 值 可以是多个
     * @return 成功个数
     */
    long sSetAndTime(String key, long time, Object... values);

    /**
     * 获取set缓存的长度
     *
     * @param key 键
     * @return
     */
    long sGetSetSize(String key);

    /**
     * 移除值为value的
     *
     * @param key    键
     * @param values 值 可以是多个
     * @return 移除的个数
     */
    long setRemove(String key, Object... values);

    //===============================list=================================

    /**
     * 获取list缓存的内容
     *
     * @param key   键
     * @param start 开始
     * @param end   结束  0 到 -1代表所有值
     * @return
     */
    List<Object> lGet(String key, long start, long end);

    List<Object> lGet(String key);

    /**
     * 获取list缓存的长度
     *
     * @param key 键
     * @return
     */
    long lGetListSize(String key);

    /**
     * 通过索引 获取list中的值
     *
     * @param key   键
     * @param index 索引  index>=0时， 0 表头，1 第二个元素，依次类推；index<0时，-1，表尾，-2倒数第二个元素，依次类推
     * @return
     */
    Object lGetIndex(String key, long index);

    /**
     * 将list放入缓存
     *
     * @param key   键
     * @param value 值
     * @return
     */
    boolean lSet(String key, Object value);

    /**
     * 将list放入缓存
     *
     * @param key   键
     * @param value 值
     * @param time  时间(秒)
     * @return
     */
    boolean lSet(String key, Object value, long time);

    /**
     * 将list放入缓存
     *
     * @param key   键
     * @param value 值
     * @return
     */
    boolean lSet(String key, List<Object> value);

    /**
     * 将list放入缓存
     *
     * @param key   键
     * @param value 值
     * @param time  时间(秒)
     * @return
     */
    boolean lSet(String key, List<Object> value, long time);

    /**
     * 根据索引修改list中的某条数据
     *
     * @param key   键
     * @param index 索引
     * @param value 值
     * @return
     */
    boolean lUpdateIndex(String key, long index, Object value);

    /***
     * 从左取出元素
     * @param key
     * @return
     */
    Object lPop(String key);

    /***
     * 从右取出元素
     * @param key
     * @return
     */
    Object rPop(String key);

    /**
     * 移除N个值为value
     *
     * @param key   键
     * @param count 移除多少个
     * @param value 值
     * @return 移除的个数
     */
    long lRemove(String key, long count, Object value);

    /**
     * 列表添加 * @param k * @param v
     */
    boolean lLeftPush(String k, Object v);


    boolean lRightPush(String k, Object v);


    /**
     * 列表获取 * @param k * @param l * @param l1 * @return
     */
    List<Object> lRange(String k, long l, long l1);

    /**
     * 集合添加 * @param key * @param value
     */
    void setArray(String key, Object value);

    /**
     * 集合获取 * @param key * @return
     */
    Set<Object> getArray(String key);

    /**
     * 有序集合添加 * @param key * @param value * @param scoure
     */
    void zAdd(String key, Object value, double scoure);

    /**
     * 有序集合获取 * @param key * @param scoure * @param scoure1 * @return
     */
    Set<Object> rangeByScore(String key, double scoure, double scoure1);

    /**
     * 有序集合获取  top num
     * return value
     */
    Set<Object> zTopNum(String key, Long topNum);

    /**
     * value add inscrement
     */
    Double zIncrementScore(String key, Object value, double increment);

    /**
     * 有序集合 移除 value
     *
     * @param key   集合key值
     * @param value 移除的value
     * @return
     */
    Long zRemove(String key, Object value);

    /**
     * 获取对应有序集合的value数量
     *
     * @param key 集合key值
     * @return
     */
    Long zSize(String key);

    /**
     * 获取范围内的 对应的value
     * score从低到高
     *
     * @param key   集合key值
     * @param start 开始的下标
     * @param end   结束的下标
     * @return
     */
    Set<Object> zRange(String key, Long start, Long end);

    /**
     * 获取范围内的 对应的value
     * score从高到低
     *
     * @param key   集合key值
     * @param start
     * @param end
     * @return
     */
    Set<Object> zReverseRange(String key, Long start, Long end);

    /**
     * 获取对应value的下标
     * score从低到高
     *
     * @param key   集合key值
     * @param value 查询的value
     * @return
     */
    Long zRank(String key, Object value);

    /**
     * 获取对应value的下标
     * score从高到低
     *
     * @param key   集合key值
     * @param value 查询的value
     * @return
     */
    Long zReverseRank(String key, Object value);

    /**
     * 获取value对应的 score
     *
     * @param key   集合key值
     * @param value 查询的value
     * @return
     */
    Double zScore(String key, Object value);

    /**
     * 加锁
     *
     * @param key
     * @param value
     * @return
     */
    boolean lock(String key, String value);

    boolean lock(String key);

    /**
     * 解锁
     *
     * @param key
     * @param value
     */
    void unlock(String key, String value);

    /**
     * 通过Score获取由小到大
     *
     * @param key
     * @param min
     * @param max
     * @return
     */
    Set<T> zRangeByScore(String key, double min, double max);

    /**
     * 通过Score获取由大到小
     *
     * @param key key
     * @param min
     * @param max
     * @return
     */
    Set<T> zReverseRangeByScore(String key, double min, double max);

    /**
     * 通过Score范围删除
     *
     * @param key
     * @param min
     * @param max
     * @return
     */
    Long zRemoveRangeByScore(String key, double min, double max);

    /**
     * 通过位置范围删除
     *
     * @param key
     * @param min
     * @param max
     * @return
     */
    Long zRemoveRange(String key, long min, long max);

}
